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ABOUT THIS MANUAL 



This manual describes the Motorola 68000 Utilities for CDCNET software development. These 
utilities are part of the Software Engineering Services (SES) tools package available under 
the Network Operating System (NOS). 

AUDIENCE 

This manual is written for the CDCNET system programmer. It assumes that the reader is 
familiar with the CYBIL programming language as described in the CDCNET CYB1L Reference 
Manual, and the Motorola MC68000 Cross-Assembler as described in the CDCNET MC68000 
Cross-Assembler manual. 

ORGANIZATION 

Chapter 1 of this manual shows how the utilities described in this manual are used in the 
CDCNET software development process. Each of the remaining chapters describes one of the 
MC68000 utilities. 

The appenxides contain supplementary information. Appendix A describes all of the 
diagnostic messages associated with the utilities. Appendix B presents the object text 
formats for the MC68000 Absolute Linker; this appendix is intended for programmers who wish 
to use object program modules other than those created by the CDCNET CYBIL compiler or the 
MC68000 Cross-Assembler as input to the Linker. 

CONVENTIONS 

Command formats in this manual follow the conventions generally used in NOS manuals for 
presenting NOS system commands. 

All of the commands used to call the utilities are actually calls to a NOS procedure. The 
procedure allows you to use an order-dependent or an order-independent format. 

• If you use the order-dependent format, you do not have to specify the reserved 
words that introduce parameter values in the commands. You must include a 
separator (comma or space) between each parameter you specify. If you omit a 
parameter from the parameter list and wish to specify a parameter that occurs 
later in the parameter list, you must include an additional separator for the 
parameter you omitted. 

• If you use the order-independent format, you must specify the reserved words that 
introduce the parameter values. You must include a separator between each 
parameter you specify, but you do not need to include additional separators for 
parameters you do not specify. 

Uppercase letters in the command formats represent reserved words; you must enter them 
exactly as shown. Lowercase letters indicate names and values that you supply. 

Optional parameters are labeled as optional in the parameter list. You must specify values 
for all parameters that are not labeled as optional. 
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Permissible abbreviations and alternate forms of parameters are shown in parentheses nex to 
the parameter definitions. 

The lowercase descriptions of parameters in the parameter lists give an indication of the 

type of the parameter. In general, the words are used in the same sense as in CYBIL (for 

example, name refers to a string of up to 31 characters). The following terms that are not 
standard CYBIL terms are also used: 

• The term file name refers to a NOS file name. 

• The term user name refers to a NOS user name. 

• The term number refers to a decimal integer or a hexadecimal integer followed by 
the integer 16 in parentheses. 
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INTRODUCTION 



The CDCNET MC68000 utilities are a set of software tools that allow you to create software 
for CDCNET device interfaces (DIs). These utilities are part of the Software Engineering 
Services (SES) tools package available under the Network Operating System (NOS). 

Figure 1-1 shows how the utilities interact to process program modules written using the 
CDCNET CYBIL compiler or the MC68000 Cross-Assembler . The commands for the utilities are 
shown in parentheses. This figure shows three major paths in preparing program modules for 
a DI. 

• Path ©uses the DI Library Translator utility (TRANDILIB). This path is used for 
creating a relocatable object library to be loaded into a DI. 

• Path(|)uses the Absolute Linker (LINK68K) and the Memory Image Builder (BLDMI68K). 
This path is used to create absolute memory images of program modules to be loaded 
into a DI . 

• Path ©uses the Absolute Linker (LINK68K) and the Object Record Translator 
(TRAN68K). This path is used in creating read-only memories (ROMs) to be installed 
in a DI. 
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Figure 1-1. Interaction of the CDCNET MC68000 Utilities 
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The Symbol Table Purger (PURSYM68K) and the Object Module Binder (BIND68K) can 
be used In all paths. 

• The Symbol Table Purger is used when the program modules generated by 
the CDCNET CYB1L compiler or the MC68000 Cross-Assembler have been 
created using the debug option. The Symbol Table Purger removes the 
debug symbol table from the file containing the program modules. The 
debug symbol table must be removed in path 1 before the DI Library 
Translator is used. 

• The Object Module Binder reduces the size of an object library by 
combining code, data, and binding sections, by optimizing the combined 
binding section for minimum redundancy, and by removing unnecessary 
entry points. The use of this utility is always optional. 

The SES Object Code Utilities, not shown in the figure, can be used to 
manipulate the object files at any point in the development of DI software. 
These utilities can be used to create object libraries from object files. The 
SES Object Code Utilities are described in the SES User's Handbook. 
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The Symbol Table Purger utility (PURSYM68K) removes the debug symbol tables from program 
modules on object files or object libraries. A debug symbol table is generated when the 
program module is created using the CDCNET CYBIL compiler or the CDCNET MC68000 
Cross-Assembler using the debug option. If you intend to make a relocatable object library 
from program modules that contain debug symbol tables, you must remove these tables before 
you use the DI Library Translator utility. 

Format: SES.PURSYM68K 

INPUT=list of file name 
OUTPUT-list of file name 
UN=user name 
optional 



Parameters: 

INPUT (I) 



Names of the files from which debug symbol tables are to be removed. These files 
need not be local. The files can be object files or object libraries. 



OUTPUT (0) 



Names of the files to which the output is to be written. These files are written 

into the permanent file catalog of the user specified in the UN parameter. For 

all input files that are object files, the output files are object files; for all 

input files that are object libraries, the output files are object libraries. 

The number of files specified in the OUTPUT parameter must be the same as the 
number of files specified in the INPUT parameter. 



UN 



c 



The user name of the permanent file catalog to be searched for input files and to 
which the output files are to be written. If you omit this parameter, your 
permanent file catalog is used. 

Example: In the following example, debug sysmol tables are removed from the program 

modules on files EXECUTV and MONITOR, and the resulting modules are written to 
files EXEC and MNTR respectively. 

SES.PURSYM68K (EXECUTV MONITOR) (EXEC MNTR) 
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OBJECT MODULE BINDER 



The Object Module Binder utility (BIND68K) creates a single. bound load module from input 
object modules. The code sections of the input modules are combined into a single code 
section, data sections with identical attributes are combined into a single section, and the 
binding sections are combined and reorganized for minimum redundancy. Entry point 
defin.it i oiis that are referenced from one or more component modules are deleted unless they 
are explicitly retained in the BIND68K command or if they have been previously retained. 

Format: SES.BIND68K 

FILE=list of (file name or (list of file name, user name)) 
NAME-name 

MODULE=list or range of name optional 

RETAIN=list of name optional 

OMIT=list of name optional 

STARTING_PROCEDURE-name optional 

UPON-file" name or (file name, user name) 

BASE=file name or (file name, user name) optional 

LOCK»file name optional 

NOLOCK optional 

OUTPUT=file name optional 

LPF=file name optional 

Parameters : 

FILE (LIBRARY, LIB, F) 

The names of the files containing program modules to be bound. Files that are 
not in your permanent file catalog must be referenced in the format (list of file 
name, user name). 

NAME (N) 

The name to be associated with the output module. 

MODULE (MODULES, M) 

The modules that are to be components of the output module. You can specify 
subranges of modules in the list of modules. If this parameter is omitted, all 
modules on the input files are used. 

RETAIN (R) 

The externally declared names in the component modules whose definitions are to 
be retained in the output module. The externally declared names are referenced 
by a component of the created module. The Object Module Binder automatically 
retains entry point names that have been retained previously. 
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OMIT (0) 

The externally declared names in the component modules whose 
definitions are to be removed in creating the output module. 

STARTING_PROCEDURE (SP) 

The externally declared name of the procedure at which execution of the 
output module is to begin. If you omit this parameter, the last 
transfer symbol encountered is used to identify the starting 
procedure. The starting procedure is always retained in the new module. 






UPON (UP) 



The name of the file to which the output module is to be written. If 
you want the output to be written to another user's permanent file 
catalog, use the format (file name, user name) for this parameter. 



BASE (B) 



IX) CK 



The name of a file of object code modules to which the output file is 
to be added. If this parameter is specified, the SES Object Code 
utilities GOF and GOL are used to append the output file to the base 
file. If you want the output to be written to another user's permanent 
file catalog, use . the format (file name, user name) for this parameter. 



This parameter specifies that the file specified in the UPON parameter 
is to be interlocked while the Object Module Binder is writing to that 
file. 



V ..;/ 



N0L0CK 



V7 



This parameter indicates that the file specified in the UPON parameter 
is not interlocked while the Object Module Binder is writing to that 
file. 



OUTPUT (OUT) 



The name of the file to which an object map of the output module is to 

be written. fT~~\ 



LPF 



jf 



The name of the file containing a list of parameters for the Object 
Module Binder. The FILE, MODULE, OMIT, RETAIN, NAME, and 
STARTING_PROCEDURE parameters can be specified in this file. The 
parameter file must contain one parameter per line, and the last line 
must consist of the word END. This file must be local to your job. 



MC68000 Utilities 3-2 Revision 01 



^Ks; 



J 






\*»y 



c 



Examples: In the following example, the input program modules are located on file MYLIB, 

which is either local or in the user's own permanent file catalog, and files 
SIN and TAN, which are in the permanent file catalog of user name FTNLIB. The 
Object Module Binder binds all program modules in the input files. The output 
module, named TRIG_FUNCT, has a starting procedure named START, and is written 
to file BOUND in the user's permanent file catalog. 

SES.BIND68K F=(MYLIB, (SIN, TAN, FTNLIB)) M=TRIG_FUNCT SP-START UP=BOUND 

In the following example, some of the parameters for the Object Module Binder 
are contained in local file BINDLPF. The input program modules are located on 
files FILE1 and FILE2, which are either local or in the user's own permanent 
file catalog. The Object Module Binder only binds program modules MODI 
through M0D4. Entry points ENT1 and ENT2 are retained in the binding 
process. The output module, named NEWMOD, has a starting procedure named 
TEST, and is written to file FILE3 in the user's permanent file catalog. An 
object map of program module NEWMOD is written to file LIST. 

SES.BIND68K LPF=BINDLPF OUT-LIST UP0N-FILE3 

File BINDLPF contains: 

FILE»(FILE1,FILE2) 

MODULE- (MODI . .M0D4) 

RETAIN-(ENT1,ENT2) 

NAME-NEWMOD 

SP-TEST 

END 
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Dl LIBRARY TRANSLATOR 



The DI Library Translator utility (TRANDILIB) translates program modules on object files or 
object libraries into packed byte-oriented data mappings to create a relocatable object 
library that can be loaded into a DI. 

Format: SES . TRANDILIB 

INPUT-list of file name 

OUTPUT=list of file name 

UN=user name optional 

keyword optional 

Parameters: 

INPUT (I) 

The names of the files to be translated. These files need not be local to your 
job. 

OUTPUT (0) 

The names of the files to which the translated files are to be written. The 
number of output files must be the same as the number of input files. 



UN 



The user name whose permanent file catalog is to be searched for input files and 
to which output files are to be written. If you omit this parameter, your 
permanent file catalog is used. 



FILE (F) 



If you specify this keyword, or if you specify no keyword, the output files are 
formatted as files rather than as libraries. 

LIB (L) 

If you specify this keyword, the output files are formatted as libraries. Each 
library file contains a program module directory and an entry point directory in 
addition to the program modules. 

Example: In the following example, the program modules on files 0BJFIL1 and 0BJFIL2 are 

translated and written to files 0BJLIB3 and 0BJLIB4 in the user's permanent file 
catalog. Files 0BJLIB3 and 0BJLIB4 are written in library format. 

SES. TRANDILIB I=(0BJFIL1 0BJFIL2) 0-(0BJLIB3 0BJLIB4) L 
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MC68000 ABSOLUTE LINKER (LINK68K) 



The MC68000 Absolute Linker (the Linker) creates a set of linked segment files from input 
object modules created by the CDCNET CYBIL compiler or the MC68000 Cross-Assembler. These 
linked segment files can be input to the Object Record Translator or Memory Image Builder 
utilities to create software for a DI. 

The Linker forms a set of memory segment images from the object text sections of the input 
object modules. Data in the memory segments is primarily referenced via pointers set up in 
the binding segment, which is initialized during the link operation. Unsatisfied externals 
are satisfied from libraries specified in the call to the Linker. 

You execute the Linker with the LINK68K command, which calls an SES procedure. Parameters 
for the call to the Linker can be specified in the LINK68K command, in a Linker Parameter 
File , or in both places . Values that you specify for parameters in the LINK68K command take 
precedence over values you specify in the Linker Parameter File. 

Format : 

SES .LINK68K 

0FL=list of file name optional 

LFL=list of file name optional 

SP-name optional 

NS=name optional 

MF=file name optional 

MO=character optional 

REWIND or NOREW optional 

LPF=file name optional 

CYBMLIB optional 

Parameters : 
OFL 

The names of up to 10 files containing input object modules for the Linker. 
LFL 

The names of up to 10 library files containing input object modules for the Linker. 

SP 

The starting procedure for the linked modules. This parameter specifies the entry 
point at which execution of the linked modules is to begin. If you omit this 
parameter, execution begins at the first transfer symbol encountered. 

NS 

The four-character name seed for the files created by the Linker. The name seed is 
used as the first four characters of the NOS file names for the header file, output 
segment files, and the outboard symbol table file. This field is ignored if the NS 
parameter is specified on the LINK68K command. If you omit this parameter, the 
characters SEGM are used as the name seed. 
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MF 



MO 



The name of the Linker map file. If you omit this parameter, the map file is 
written to file LINKMAP. 



This parameter specifies the amount of information to be included in the 
Linker map file. Values for this parameter are: 

N No map information. 

S Section allocations for each section of each input object module. 

E Section allocations, entry points names and address assignments. 

M Section allocations, entry points, and output segment and common 
block allocations. 

I Section allocations, entry points, output segment and common block 
allocations, and Inboard Symbol Table (full linker map). 



REWIND 



If you specify this parameter, the Linker map file is rewound before it is 
written. If you specify neither REWIND nor NOREW, the Linker map file is 
rewound . 



NOREW 



If you specify this parameter, the Linker map file is not rewound before it is 
written. 



LPF 
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The name of a file containing a list of parameters for the Linker (see Linker 
Parameter File later in this chapter). If you omit this parameter, the 
default values for parameters described under Linker Parameter File are used. 

CYBMLIB (DIOSLIB) 

If you specify this parameter, the Linker uses SES library file CYBMLIB to / ">-, 

satisfy external references during the linking process. The Linker accesses 
this file and adds it to the library file list. If you omit this parameter, ^ ^ 

CYBMLIB is not used to satisfy external references. 

Example: In the following example, the object modules on files LGOl and LG01 are input 

to the Linker, and the remaining parameters for the Linker are specified in 
file MYLPF. 

SES.LINK68K 0FL-(LGOl,LGO2) LPF=MYLPF 



c 



,J 



c 



C 



c 



LINKER PARAMETER FILE 

A Linker parameter file is a file of subcommands that control the operation of the Linker. 
The Linker parameter file allows you to specify a number of parameters that can not be 
included in the LINK68K command. You specify the LPF parameter in the LINK68K command to 
indicate that you are including a Linker parameter file. The Linker parameter can contain 
the following subcommands: 

• LINK_OPTIONS 

• OBJECTJILE 

• OBJECT_LIBRARY 

• DEFINE_SEGMENT 

• OBJECT_MODULE 

• INBOARD_SYMBOL_TABLE 

• INCLUDE_LINKED_SYMBOLS 

• END 

The subcommands must be on separate lines in the Linker parameter /file. If you need to 
continue a subcommand on a second or subsequent line, you must end every line in the 
subcomand except the last line with two periods (..) to indicate that a continuation line 
follows. 



LINK .OPTIONS Subcommand 

The LINKjOPTIONS subcommand provides parameters for the LINK68K command. With the exception 
of the MAX_EXTERNALS and HEAP_SIZE parameters, all parameters for this subcommand can be 
specified in the LINK68K command. Any values specified for these parameters in the LINK68K 
command override the values specified in the LINKjOPTIONS subcommand. 

Only one LINK_0PT10NS subcommand may be included in the Linker parameter file. If you omit 
this subcommand, values for parameters not specified in the LINK68K command are the same as 
the values used when the individual parameters are omitted. 

Format: LINKjOPTIONS. &MAP_FILENAME=file name,&MAP_OPTIONS=character,&REWIND_MAP, . . 

&NAME_SEED=name,&MAX_EXTERNALS=integer , &HEAP_SIZE«integer , &STARTING_PROCEDURE=name 



Parameters: 

MAP_FILENAME 

The name of the Linker map file. If you omit this parameter, the map file is 
written to file LINKMAP. 



o 
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MAP_OPTIONS 

This parameter specifies the amount of information to be included in the Linker map 
file. Values for this parameter are: 

N No map information. 

S Section allocations for each section of each input object module. 

E Section allocations, entry points names and address assignments. 

M Section allocations, entry points, and output segment and common block 
allocations. 

I Section allocations, entry points, output segment and common block 
allocations, and Inboard Symbol Table (full linker map). 

REWIND_MAP 

If you specify this parameter, the Linker map file is rewound before it is written. \ 

If you specify neither REWIND_MAP nor NO_MAP_REWIND, the Linker map file is rewound. 

NO_MAP_EEWIND 

If you specify this parameter, the Linker map file is not rewound before it is 
written. 

NAME_SEED 

The four-character name seed for the files created by the Linker (the header file, i 

the segment files, and the Outboard Symbol Table file). The name seed is used as \_ 

the first four characters of the NOS file names for the header file, output segment 
files, and the outboard symbol table file. This field is ignored if the NS 
parameter is specified on the LINK68K command. If you omit this parameter, the 
characters SEGM are used as the name seed. 

MAX_EXTERNALS 

The maximum number of external references to be allowed in the link operation. If 
you omit this parameter, a value of 300 is used. 



"*W' 



HEAP_SIZE 

The size, in bytes, of the system heap for object modules generated by the CDCNET 
CYBIL compiler. This value overrides the value specified in the object modules. If 
you omit this parameter, the heap sizes specified in the individual object modules 
are used for each module; if no object module specifies a heap size, a value of zero 
is used. For further information about the system heap, refer to the CDCNET CYBIL 
Reference Manual. 

STARTING_PRDCEDUBE 

The starting procedure for the linked modules. This parameter specifies the entry 
point at which execution of the linked modules is to begin. If you omit this 
parameter, execution begins at the first transfer symbol encountered. 
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OBJECT _ FILE and OBJECT - LIBRARY Subcommands 

The OBJECT_FILE and OBJECTJLIBRARY subcommands specify the input files to the Linker and 
provides names for sections of the input files. Any values specified for the OFL and LFL 
parameters in the LINK68K command override the values specified in the OBJECT_FILE and 
OBJECT_LIBRARY subcommands. You should include one OBJECT_FILE subcommand for each input 
file that is not in library format and one one OBJECT_LIBRARY subcommand for each input file 
that is in library format. 

Format : 

OBJECT_FILE,FlLENAME=file name,DEFAULT_SECTION=list of (name.list of character) 
OBJECT_LIBRARY,FILENAME=file name,DEFAULT_SECTION=list of (name, list of character) 

Parameters: 

FILENAME , 

Name of the local file containing input object modules for the Linker. This file 
must be local to your job. 

DEFAULT_SECTION 

The names to be associated with any unnamed sections of the input file, and the 
attributes to be assigned to those sections. Values for the section attributes are: 

R Read. 

W Write. 

E Execute . 
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DEFINE - SEGMENT Subcommand 

The DEFINE_SEGMENT subcommand allows you to define an absolute program segment. You can 
include any number of DEFINE_SEGMENT subcommands in the Linker parameter file. You must 
specify either the LOAD_ADDRESS parameter or the EXECUTE_ADDRESS and ATTRIBUTES parameters 
for each DEFINE_SEGMENT subcommand. 

Format : DEF INE_SEGMENT ,LOAD_ADDRESS-(number ) ,EXECUTE_ADDRESS=(number ) , . . 

ATTRIBUTES=(list of name ),SECTION_NAME= (list of name) 

Parameters: 

LOADJVDDRESS 

The absolute address (or byte offset) at which the segment is to be loaded. This 

number may be a decimal integer, or a hexadecimal integer in the format 

(hexadeximal integer(16)) . /' N 

V- J 
EXECUTE_ADDRESS 

The absolute address (or byte address) at which the segment is to executecif ies 
where the segment will ultimately execute. This number may be a decimal integer, or 
a hexadecimal integer in the format (hexadeximal integer(16)) . If you specify 
neither LOAD_ADDRESS nor EXECUTE_ADDRESS , offset loading is not performed. 

ATTRIBUTES 

The access attributes for the segment. You can specify any combination of the /r x, 

following attributes: ■[ 

RD Read. 

WT Write. 

EX Execute . 

ET Extend. 

SECTIONJJAME 

The names of Working_Storage sections to be mapped into this section. L J 
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OBJECT _ MODULE Subcommand 

The OBJECT_MODULE subcommand specifies names of modules to be included in the link 
operation. You may include only one OBJECT_MODOLE subcommand in the Linker parameter file. 

Format: OBJECT_MODULE,NAME=list of name 

Parameters: 

NAME Names of modules to be included in the link operation. 



INBOARD - SYMBOL -TABLE Subcommand 

The INBOARD_SYMBOL_TABLE subcommand specifies files that contain Inboard Symbol Tables to be 
passed to the Linker. An Inboard Symbol Table is a table of entry points resolved in a 
previous link operation. An Inboard Symbol Table allows you to link only the code that will 
be executed. You may include only one INBOARD_SYMBOL_TABLE subcommand in the Linker 
parameter file. 

Format: INBOARD_SYMBOL_TABLE,NAME-list of file name 

Parameters : 

NAME Names of files containing Inboard Symbol Tables. 
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INCLUDE _ LINKED - SYMBOLS Subcommand 

The INCLUDE_LINKED_SYMBOLS subcommand copies the Outboard Symbol Table into a segment file 
defined in a DEF INE_SEGMENT subcommand for the current link operation. This subcommand is 
processed after the link operation is complete. 

Format ; INCLUDE_LINKED_SYMBOLS ,POINTER=name , SECTI0N=name 

Parameters : 



POINTER 



The name of a pointer to the adaptable array to which the Outboard Symbol Table 
is to be written. This subcommand causes the adaptable pointer to be 
initialized. The variable name must be defined in the current link operation. 



SECTION 



The section name of the segment in which the linked symbol table is to be / "\ 

included. You must define this segment with a DEFINE_SEGMENT subcommand in the \ 

current link operation. . •■-.y 



END Subcommand 

The END subcommand indicates end of the Linker parameter file. If you omit this subcommand, 
the Linker uses the end-of-inf ormation of the file to determine the end of the Linker 
parameter file. 

Format: END f ~N 

Y_y 

The following example shows a call to the Linker that uses a Linker parameter file. The 
Linker parameter file specifies three input object files and defines seven object segments. 

SES.LINK68K LPF-LPARAM1 

File LPARAMl contains: 

LINK_OPTIONS ! MAX_EXTERNALS=50Q ,NAME_SEED=LNK1 

OBJECT_FILE FILENAMR=SYS DEFAULT SECTION((EXEC R R) (COMN R W) ^-^ 

OBJECTJFILE FILENAME=REL1 DEFAULT SECTION (( CODE 1 R E)) ' 

OBJECT FILE F ILENAME=REL2 DEFAULT SECTION ((C0DE2 RE)) H, > 

DEFINE~SEGMENT (00(16)) ATTRIBUTES=(RD EX WT) ALS$ORG_00000000 

DEFINE~SEGMENT (30(16)) ATTRIBUTES-(RD EX WT) ALS$ORG_00000030 

DEFINE SEGMENT (80(16)) ATTRIBUTES -(RD EX WT) ALS$0RG_00000080 

DEFINE_SEGMENT (8800(16)) ATTRIBUTES»(RD EX) (EXEC CODED 

DEFINE_SEGMENT (111400(16)) ATTRIBUTES=(RD EX) C0DE2 

DEFINE SEGMENT (111000(16)) ATTRIBUTES=(RD WT) DATA 

DEFINE_SEGMENT (8400(16)) ATTRIBUTES=(RD WT) COMN 

END 
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LINKER FILE FORMATS 

The following sections describe the formats of the files that are input to the Linker and 
the output files created by the the Linker. 



INPUT FILES 

The files that constitute the input to the Linker are object files, object libraries, and 
files containing Inboard Symbol Tables. You must specify at least one object file or object 
library as input to the Linker; an Inboard Symbol Table is not required. 

Object Files 

Object files contain object modules created by the CDCNET CYBIL compiler or the CDCNET 
MC68000 Cross-Assembler. Several object modules may reside on a single object file. 

*\ 

*»S: Each object module consists of an identification record, a sectfon definition record, and 

the object text associated with the sections. The identification record describes the 
external characteristics of the object module (module attributes and the number of 
sections). Each section in the object module contains a section definition record that 
describes the attributes of the section (code, binding, working storage, or common). 

Appendix B contains the object module type definition for object files that are input to the 
Linker . 



^^r 
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Library Files 

In addition to object files, the Linker accepts MC68000 library files as input. MC68000 
library files contain object modules formatted into a library by the SES Object Code 
Utilities (refer to the SES User's Handbook for a description of these utilities). The 
object module structure for library files is identical to the object module structure for 
object files. 

Appendix B contains the library record definition for library files that are input to the 
Linker. 

Inboard Symbol Table Files 

The Inboard Symbol Table file contains a table of gated entry points created in one 
execution of the Linker. A symbol table is called an Inboard Symbol Table when used as 
input to the Linker; the same symbol table is called an Outboard Symbol Table when it is 
created by the Linker. An Outboard Symbol Table file is generated by the Linker if entry 
points that have the gated attribute are encountered during a link operation. Gated entry 
points are associated with gated variables, functions, and procedures in CYBIL object 
modules (refer to the CDCNET CYBIL Reference Manual). 



OUTPUT FILES 

The Linker creates a header file and a number of segment files during each successful link 
operation. Depending on the parameters specified in the call to the Linker, an Outboard 
Symbol Table and a Linker map may also be created. 
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Header File 

The Linker creates a header file that describes the results of the link operation. The name 
of the header file is the name seed, specified in the NAMEJSEED parameter, followed by the 
characters HDR. For example, if the name seed is SEGM, the header file is named SEGMHDR. 

The header file contains a header variant and a segment descriptor variant for each segment 
file created in the link operation. The header variant contains the number of segment 
descriptors, the initial program address and its key, and the binding section address. The 
segment descriptor contains the name of the file on which the segment was written and its 
segment attributes. 

Segment Files 

The Linker outputs segment files that can be input to the Memory Image Builder and Object 
Record Translator utilities. A segment file contains a load file directory and a linked 
se gment . 



/ 



The names of the segment files are generated by adding a three-digit number to the name seed 

specified in the NAME_SEED parameter. A unique three-digit number, starting with 101, is Y V 

used for each segment file. For example, if the name seed is SEGM and four segment files 

are created, their names are SEGM101, SEGM102, SEGM103, and SEGM104. 

The Linker allocates and creates segment files during a link operation. You can explicitly 
allocate a segment using the DEFINE_SEGMENT subcommand in the Linker parameter file. 



Outboard Symbol Table File 

The Outboard Symbol Table file contains a table of gated entry points created in one 
execution of the Linker. An Outboard Symbol Table file is generated by the Linker if antry 
points that have the gated attribute are encountered during a link operation. Gated entry 
points are associated with gated variables, functions, and procedures in CYBIL object 
modules (refer to the CDCNET CYBIL Reference Manual). The Outboard Symbol Table file name 
is tne name seea specxrxea in tne aRMc_pciC.u parameter loxiOWeu oy lik smuj uox. 

Linker Map 

The Linker map shows the address assignments made by the Linker. You specify the name of 
the file onto which the linker map is written either as a parameter in the LINK68K command 
or as parameter of the LINKjOPTIONS subcommand in the Linker Parameter File. The linker map 
contains four parts; you have the option of selecting, all, some, or none of these parts to 
be included in the Linker map. The four parts ares 

• Section Definitions 

• Entry Point Names 

• External References 

• Output Segments and Common Blocks 
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Section Definitions 

The following information is printed for every section of every object module: 

Section type (working storage or code). 

Access attributes (read, write, or execute). 

Length, in bytes. 

Address (load address and execution address if different). 

Section name or default section name if applicable. 



Entry Point Names 

The following information is printed for every entry point: 

• Name . 

• An indication as to whether the entry point is gated or not gated. 

• Address (load address and execution address if different). 



o 






External References 

A list of the external references is printed after the entry point list. 

Output Segments and Common Blocks 

The following information is printed for every output segment allocated by the Linker: 

File name. 

Address (load address and execution address if different). 

Length, in bytes. 

Access attributes (read, write, or execute). 

Section names associated with the segment. 
The following information is printed for every common block allocated by the Linker: 

Name. 

Access attributes. 

Length, in bytes. 

Address (load address and execution address if different). 
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Figure 5-1 shows an example of a full Linker map. The section definitions portion of the 
map shows that the three input object modules T01M0NT, T01CYBM, and T01ASM1 were involved in 
a link operation. The entry point names portion shows that a single entry point TEST was 
present. The absence of an external references portion indicates that no external 
references were encountered. The output segments and common blocks section shows that the 
four segment modules T001101, T001102, T001103, and T001104 were created by the Linker. 



MODULE 

FILE 



T01M0NT 
T01M0NR 



LINKER V 4.1 OUTPUT LISTING 



July 11, 1984 



LANGUAGE 
5:12 PM 



9/24/84 
ASSEMBLER 



16.00.46 



SECTION TYPE/ 
ACCESS ATTRIBUTES 



LENGTH 



LOAD/ 
EXECUTION ADDR 



WORKING STORAGE - ALS$ORG_00000000 
READ WRITE EXECUTE 



30 



000 000000000 



.<• -\ 



WORKING STORAGE - ALS4ORG_0000007C 
READ WRITE EXECUTE 



000 00000007 C 



WORKING STORAGE - ALS40RG_0000007C 
READ WRITE EXECUTE 

CODE - MONR 
READ EXECUTE 



578 



000 00000008C 

PROG 

000 000000400 



ENTRY POINT DEFINITIONS 
M0NITORJC0NTR0L 
M0NIT0R_REGISTE 
XFR_BUF 

MONITOR_MESSAGE 
M0NIT0R_ENTRY 
RESET_ENTRY 
SPECIAL ENTRY 



NOT GATED 
NOT GATED 
NOT GATED 
NOT GATED 
NOT GATED 
NOT GATED 
NOT GATED 



ADDRESS 
000 0000086C 
000 00000802 
000 00000878 
000 00000850 
000 00000400 
000 00000634 
000 00000498 






TOTAL MODULE LENGTH 



580 






Figure 5-1. Example Linker Map 
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MODULE 
FILE 



TOICYBM 
TOICYBR 



1984/07/11 



LANGUAGE = CYBIL 
17:14:02 



SECTION TYPE/ 
ACCESS ATTRIBUTES 



LOAD/ 
LENGTH EXECUTION ADDR 



CODE - CYBER 
READ EXECUTE 



60 000 000000978 



WORKING STORAGE - DATA1 
READ 



2A 000 0000009D8 



WORKING STORAGE - DATA2 
READ WRITE 



20 000 000000A02 



ENTRY POINT DEFINITIONS 
TEST 



ADDRESS 
NOT GATED 000 00000978 



EXTERNAL ENTRY POINTS REFERENCED 
SCAN 






TOTAL MODULE LENTH 



AA 



MODULE - T01ASM1 

FILE = T01ASMR July 11, 1984 



LANGUAGE = ASSEMBLER 
5:12 PM 






SECTION TYPE/ 
ACCESS ATTRIBUTES 



CODE - ASMR 
READ EXECUTE 



LOAD/ 
LENGTH EXECUTION ADDR 



- PROG 
46 000 000000A22 



ENTRY POINT DEFINITIONS 
SCAN 



ADDRESS 
NOT GATED 000 O0OO0A22 



TOTAL MODULE LENTH 



46 



Figure 5-1. Example Linker Map (Contd.) 
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SES/MC68000 LINKER OUTPUT 

PRIMARY ENTRY POINT - TEST 
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ID = $00OO000000000OOO0O00C003SRXMDO 



FILE NAME/ 
ACCESS ATTRIBUTES 
SECTION NAMES 



TOO 1101 

READ WRITE EXECUTE 
ALS$ORG_0OOOO0BC 

TOO 11 02 

READ WRITE EXECUTE 
ALS$ORG_0000007C 

TOO 1103 

READ WRITE EXECUTE 
ALS$ORG 00000000 



LOAD/ 

LENGTH EXECUTION ADDR 



4 * 000 0000008C 



4 * 000 0000007 C 



30 * 000 00000000 






TOO 1104 

READ WRITE EXECUTE 

MONR 

AS MR 

CYBR 

DATA1 

DATA2 



668 * 000 00004000 






- TOTAL LENGTH 



6aO 



BO LINKER ERRORS WERE DETECTED 






Figure 5-1. Example Linker Map (Contd.) 
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LIMITATIONS OF THE LINKER 

The Linker performs only cursory checks to determine if you have specified any duplicate 
input file names. 

The Linker performs no checks to determine if any file names generated using the NAME_SEED 
parameter duplicate any file names you have specified in the call to the Linker. You must 
resolve any file naming conflicts resulting from the use of the name seed prior to executing 
the Linker command. Creation of duplicate file names may cause the Linker to abort or yield 
unpredictable results. 

The Linker is sensitive to portions of the data on an object file. It uses some of the data 
for computations. Therefore, an object file that has been incorrectly generated may cause 
the Linker to abort or yield unpredictable results. 



o 
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OBJECT RECORD TRANSLATOR 
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The Object Record Translator utility (TRAN68K) translates files created by the MC68000 
Absolute Linker into files of Motorola type S records. Output files can be used as input to 
a ROM programmer to create ROMs that can be installed in Dls. 

Format: SES.TRAN68K. 

HDR=file name 

SREC=file name 

UN=user name optional 

Parameters: 

HDR (H) 

The name of the header file generated by the MC68000 Absolute Linker for the 
program modules to be translated. The header file name has the form seedHDR, 
where seed is the name seed specified in the call to the Linker for the program 
modules. The header file contains information about additional files needed to 
create the type S records. 

SREC (S) 

The name of the file to which the translated program modules are to be written. 

UN 

The user name whose permanent file catalog is to be searched for input files and 
to which output files are to be written. If you omit this parameter, your 
permanent file catalog is used. 

Example: In the following example, the program modules referenced in file SEGMHDR are 

translated into Motorola type S records. The output is written to file SRECFIL 
in the user's permanent file catalog. 

SES.TRAN68K SEGMHDR SRECFIL 



o 

o 
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MEMORY IMAGE BUILDER 



The Memory Image Builder utility (BLDMI68K) creates an absolute module from output files of 
the MC68000 Absolute Linker. The output module can be loaded directly into a DI. 



Format: SES.BLDM168K 

NAME-file name 



HDR=file name 

OUTPUT-file name optional 

UN-user name optional 






Parameters: 

NAME 



The name to be associated with the absolute module created. 



HDR (H) 



o 



The name of the header file generated by the MC68000 Absolute Linker 
for the program modules to be processed. The header file name has the 
form seedHDR, where seed is the name seed specified in the call to the 
Linker for the program modules (refer to chapter 5). The header file 
contains information additional files needed to create the absolute 
module. 



OUTPUT (0) 



The name of the file to which the absolute module is to be written. If 
you omit this parameter, the absolute module is written to a file named 
MIBMOD. 



UN 






The user name whose permanent file catalog is to be searched for input 
files and to which output files are to be written. If you omit tMs 
parameter, your permanent file catalog is used. 

Example: In the following example, an absolute module named ABSMOD is created from the 

files referenced in file SEGMHDR and written to file NEWMOD in the user's 
permanent file catalog. 

SES.BLDMI68K ABSMOD SEGMHDR NEWMOD 



O 
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DIAGNOSTIC MESSAGES 
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The CDCNET MC68000 Utilities generate the following three types of diagnostic messages: 

• Diagnostic messages written by the MC68000 Absolute Linker to the Linker map file. 

• Diagnostic messages issued by the Linker only that are displayed at the interactive 
terminal and written to the job dayfile. 

• Diagnostic messages issued by all of the CDCNET MC68000 Utilities that are displayed 
at the interactive terminal and written to the job dayfile. 

LINKER MAP FILE DIAGNOSTIC MESSAGES 

The Linker writes all messages to the Linker map file in the following format: 

* * * LINKER ERROR NNNNN *FATAL* error message text 
MODULE =name 
FILE sfile name 
NAME sname 
RECORD COUNT =integer 

The string *FATAL* appears only if the error being reported was fatal to the link 
operation. NAME indicates the entry point at which the error occurred. 

1 IMPROPER RELOCATION ADDRESS SPECIFICATION 

Description: Relocation information is being incorrectly generated; Linker output 

is unaffected. 
Action: Correct the object text. 

2 UNANTICIPATED EOR 

Description: The Linker encountered an EOR somewhere other than at the end of an 

object module. 
Action: Correct the object text. 

3 MORE THAN ONE CODE SECTION IN A MODULE 

Description: A single object module had more than one code section; only one is 

permitted . 
Action: Correct the object text. 
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11 CONFLICTING PROTECTION ATTRIBUTE FOR COMMON BLOCK 
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4 SDO GREATER THAN IDR SPECIFICATION ENCOUNTERED 

Description: The number of sections in the IDR is incorrect or the section 

ordinals do not start at zero or are not contiguous. 
Action: Correct the object text. 

5 CODE SECTION ATTRIBUTE SPECIFICATION ERROR 

Description: A code section was found to have a write or binding section 

attribute. 
Action: Correct the object text. 

6 MORE THAN ONE BINDING SECTION PER MODULE 

Description: An object module had more than one binding section; only one is 

permitted. 
Action: Correct the object text. 

7 BINDING SECTION ALIGNMENT ERROR 

Description: The binding section for a module was not aligned on a 16-bit word r ^ 
boundary . ^w^' 

Action: Correct the object text. 

8 BINDING SECTION ATTRIBUTE SPECIFICATION ERROR 

Description: The binding section for a module had a write or execute attribute. 
Action: Correct the object text. 

9 DUPLICATE SECTION DEFINITION ORDINAL 



Description: The same ordinal has been used for two sections in a single object 

module . V. 

Action: Correct the object text. 

10 BINDING ATTRIBUTE SPECIFIED FOR A NON BINDING SECTION 

Description: The binding attribute was specified for a section other than the 

binding section. 
Action: Correct the object text. 



/ 



/•"~N 



Description: Different protection has been specified in separate common block 'X^ 

declarations . 
Action: Correct source program. 

12 CONFLICTING LENGTH SPECIFICATION FOR COMMON BLOCK 

Description: Unequal lengths were specified in separate common block declarations. 
Action: Correct source program. 

13 COMMON TABLE OVERFLOW - RECOMPILE LINKER 

Description: Linker internal table size was exceeded. 
Action: Correct the object text. 
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14 MISPLACED IDR OR SDC 

Description: Object text structure is incorrect. 
Action: Correct the object text. 

17 SDOS NOT CONTIGUOUSLY NUMBERED 

Description: Object text structure is incorrect. 
Action: Correct the object text. 

18 SEGMENT TABLE OVERFLOW - RECOMPILE LINKER 

Description: Linker internal table size was exceeded. 
Action: Contact your CDC customer representative. 

19 ZEROIZE SECTION INTERNAL LOGIC ERROR 

Description: The Linker has aborted. 

Action: Contact your CDC customer representative. 

21 POINTER IN BINDING SEGMENT WAS MISALIGNED 

Description: A binding section entry was not right-justified in a 16-bit word 

boundary. 
Action: Correct the object text. 

22 ATTEMPTED TO PLACE DATA IN A BINDING SECTION 

Description: A binding section entry was not a pointer or a procedure descriptor. 
Action: Correct the object text. 

24 PREALLOCATED BINDING SEGMENT ATTRIBUTE ERROR 

Description: A binding segment was defined as writable, executable, or readable 

under key lock control. 
Action: Correct the DEFINE_SEGMENT subcommand for the segment. 

25 PREALLOCATED EXECUTABLE SEGMENT ATTRIBUTE ERROR 

Description: An executable segment was defined as writable. 
Action: Correct the DEFINE_SEGMENT subcommand for the segment. 

J 28 FIRST RECORD OF AN OBJECT MODULE WASNT AN IDR 

Description: An input file to the Linker did not have the correct format. 
Action: Correct input file. 

29 DUPLICATE ENTRY POINT WAS DETECTED 

Description: A symbol contains more than one XDCL as an entry point. The Linker 

used the first definition; Linker output is unaffected. 
Action: Correct object file list if necessary. 

30 LST OVERFLOW - TOO MANY ENTRY POINTS 

Description: Linker internal table size was exceeded. 
Action: Contact your CDC customer representative. 



c 
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31 EXTERNAL ARRAY OVERFLOW - TOO MANY EXTERNALS 
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Description: Linker internal table size was exceeded (maximum size is 200 

entries . ) 
Action: Contact your CDC customer representative. 

32 RECORD CONTAINS IMPROPER SDO 

Description: An object text record referenced an undefined object text section. 
Action: Correct the object text. 

33 INPUT RECORD CONTAINS AN IMPROPER SECTION OFFSET 

Description: An object text record referenced an offset outside the range 

specified in the section definition. 
Action: Correct the object text. 

34 NO PRIMARY ENTRY POINT ENCOUNTERED 

Description: No primary entry point was specified. 
Action: Correct the object text. 

35 PRIMARY ENTRY POINT NOT XDCLED 

Description: The XDCL attribute was not assigned to the object module containing 

the primary entry point. 
Action: Assign the XDCL attribute to the appropriate program module. 

36 NO OBJECT FILE INPUT 



Description: No object module input was encounted by the Linker. 
Action: Check the input files for content and check the format of the input 
file parameters in the call to the Linker. 



V 



37 UNSATISFIED EXTERNAL REFERENCE 

Description: An externally referenced (XREF) declaration was not externally 

declared (XDCL) in any input module or in any of the modules on the 
referenced libraries. 

Action: Check your source program for a missing XDCL, and check the format 
of the input file parameters in the call to the Linker. 

38 LFD CONTAINS IMPROPER EXECUTE ATTRIBUTE 

Description: An unknown execute attribute was specified in LFD. 
Action: Correct LFD. 

39 UNKNOWN OBJECT TEXT RECORD TYPE 

Description: Object text structure is incorrect. 
Action: Correct the object text. 

40 UNKNOWN EXTERNAL REFERENCE INSERTION TYPE 

Description: Object text structure is incorrect. 
Action: Correct the object text. 
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41 UNKNOWN SECTION DEFINITION TYPE 

Description: Object text structure is incorrect. 
Action: Correct the object text. 

42 RIF DOES NOT PERTAIN TO CODE OR BINDING SECTION 

Description: Relocation information is being incorrectly generated. Linker 

output is unaffected. 
Action: Correct the object text. 

43 IMPROPER RELOCATION CONTAINER SPECIFICATION 

Description: Relocation information is being incorrectly generated. Linker 

output is unaffected. 
Action: Correct the object text. 

44 EXPECTED SDC RECORD 

Description: Object text structure is incorrect. 
Action: Correct the object text. 

45 INVALID PROCEDURE OFFSET FOR INDIRECT CALL 

Description: The byte offset for an indirect procedure call is not divisible by 2. 
Action: None necessary at this time, but the object text generator should be 
modified to allocate all procedures on a word boundary. 

46 INVALID BIT STRING INSERTION RECORD 

Description: The Linker encountered a bit string insertion record with a bit 
offset greater than 7 or a bit length greater than 63. No bit 
string insertion has taken place. 

Action: The utility that generated the object text has caused the error and 
must be corrected. 

47 BAD LIBRARY FORMAT 

Description: An input file that was specified as a library was not in library 

format . 
Action: Check the input files that were specified as libraries. 

48 REQUIRED LIBRARY MISSING 

Description: The Linker encountered a libraries record that specified a library 
not present in the list of input library files. 

Action: Correct the list of input library files in the call to the Linker to 
include the missing library. 

49 ERROR IN PARAMETER VERIFICATION 

Description: The type declarations for the variable do not match on the XDCL and 

XREF statements. 
Action: Check the type declarations for the variable and correct them so 

that they match. 
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LINKER DAYFILE MESSAGES 

The following messages are issued for the Linker only. They are displayed at the 
interactive terminal and written to the job dayfile. 
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10000 LINKER TERMINATED NORMALLY 

Description: The Linker has terminated normally with no fatal or nonfatal 

errors . 
Action: None. 

10100 LINKER NORMAL TERMINATE WITH NONFATAL ERRORS - SEE MAP LISTING 

Description: One or more non-fatal errors were encountered during the link 

operation. Linker output may or may not be valid. 
Action: Check Linker map for further diagnostic messages. 

10101 LINKER ABNORMAL TERMINATE - SEE MAP LISTING 

Description: The Linker detected a fatal error and aborted. Linker output 

is undefined. 
Action: Check Linker map for diagnostic message. 

10102 LINKER ABNORMAL TERMINATE - NO MODULES PROVIDED 

Description: The Linker found no input object modules. 

Action: Check the file input parameters on the call to the Linker and 
check all input files for content. 

10200 LIBRARY FILE file name NOT LOCAL 

Description: The file specified in the LFL parameter of the LINK68K command 
or the OBJECTJLIBRARY subcommand of the Linker Parameter File 
is not a local file. 

Action: Make the file local. 

10201 OBJECT FILE file_name NOT LOCAL 

Description: A file specified in the 0FL parameter of the LINK68K command or 
the OBJECT_FILE subcommand of the Linker Parameter File is not 
a local file. 

Action: Make the file local. 

10202 OBJECT FILENAME f ile_name DUPLICATES EXISTING FILE 

Description: A file name specified as an input object file or library is 
identical to the name of another file used by the Linker. 

Action: Change the name of one of the file names involved in the 
duplication. 

10203 1ST FILE f ile_name NOT LOCAL 

Description: A file specified in the INBOARD_SYMBOL_TABLE subcommand of the 

Linker Parameter File is not a local file. 
Action: Make the file local. 
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10204 1ST FILENAME file_name DUPLICATES EXISTING FILE 

Description: A file name specified in the INBOARD_SYMBOL_TABLE subcommand of 
the Linker Parameter File is identical to the name of another 
file used by the Linker. 

Action: Change the name of one of the file names involved in the 
duplication. 

10300 LPF FILE f ile_name" NOT LOCAL 

Description: A file specified in the LPF parameter of the LINK68K command is 

not a local file. 
Action: Hake the file local. 

10301 UNKNOWN LPF COMMAND command SPECIFIED 

Description: The Linker detected an invalid Linker Parameter File subcommand. 
Action: Correct the Linker Parameter File subcommand. 

10302 INVALID MAP OPTION map_option SPECIFIED 

Description: The Linker detected an invalid map option specified in the the 
MO parameter of the LINK68K command or in the MAP_OPTIONS 
specification of the LINK_OPTIONS subcommand in the Linker 
Parameter File. 

Action: Correct the map option specification. 

10303 INVALID NAME_SEED XXXX SPECIFIED 

Description: The Linker detected an invalid name seed specified in the NS 
parameter of the LINK68K command or in the NAME_SEED 
specification of the LINK_OPTIONS subcommand in the Linker 
Parameter File . 

Action: Correct the name seed specification. 

10304 INVALID SEGMENT ATTRIBUTE segment_attribute SPECIFIED 

Description: The Linker detected an invalid segment attribute specified in 
the ATTRIBUTES specification of DEFINE_SEGMENT subcommand in 
the Linker Parameter File . 

Action: Correct the attribute specification. 

10306 INVALID SECTION ATTRIBUTE SPECIFIED 

Description: The Linker detected conflicting access attributes in the 

specification of a default section name. 
Action: Correct the access attributes. 
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The following messages are issued for all the MC68000 Utilities. The message indicated as 
being error messages reflect conditions that cause the utility to abort. These messages are 
displayed at the interactive terminal and written to the job dayfile. 



20001 



HEADER FILE file name IS BAD 



Severity: Error. 

Description: The specified file does not have the header file format. 



20002 



SEGMENT FILE file name NOT FOUND 



Severity : Error . 
Description: Self-explanatory. 



20003 ACQUIRE ERROR file_name 



Severity : Error . 

Description: Internal error trying to acquire file_name. 
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20004 USER ID long_user_id IS TOO LONG, NOW short_user_id 

Severity: Informational 
Description: Self-explanatory. 

20005 SYMBOL long_symbol HAS BEEN SHORTENED TO short_symbol 



20006 



Severity: Informational 
Description: Self-explanatory. 

UNKNOWN OBJECT TEXT IN file name 






Severity: Error. 
Description: Self-explanatory. 



20007 



UNEXPECTED EOF OR EOR FOUND 



20008 



Severity: Error. 
Description: Self-explanatory. 

TOO MANY EXTERNAL REFERENCES 






Severity: Error. 
Description: Self-explanatory. 



20009 



MODULE module name IS NOT A MC68000 MODULE 



Severity : Error . 
Description: Self-explanatory. 



20010 



DUPLICATE ENTRY POINT NAME 



Severity: Error. 

Description: Entry point name specified more than once. 



r> 
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20011 MODULE module_name IS ALREADY ABSOLUTE AND CANNOT BE REFORMATTED 

Severity: Error. 

Description: Input modules must be relocatable. 



20012 



ORG ADDRESS FOR section name IS INVALID 



Severity: Error. 

Description: The new module is made up of too many modules. 

20201 MULTIPLE IDENTIFICATION RECORDS FOUND ON MODULE module_name 

Severity: Error. 
Description: Self-explanatory. 



20202 



SECTION OF NEW MODULE IS TOO LONG 



c 



20204 



Severity: Error. 

Description: The new module is made up of too many modules. 

UNKNOWN SECTION ORDINAL FOUND ON MODULE module_name 



Severity: Error. 

Description: Recompile the module. 

20205 MISSING SECTION DEFINITION ON MODULE module_name 

Severity: Error. 

Description: Recompile the module. 

20206 REFERENCING OUTSIDE SECTION ON MODULE module_name 

Severity: Error. 
Description: Recompiled module. 



20207 



TOO MANY LIBRARIES ENCOUNTERED 



c 



Severity: Error. 
Description: Self-explanatory. 

20211 STARTING PROCEDURE start_proc_name NOT IN CODE SECTION 

Severity: Error. 
Description: Self-explanatory. 



20217 ATTEMPTING TO BIND module_name, AN ABSOLUTE MODULE 

Severity: Error. 

Description: Module_name cannot be bound. 

20218 COMMON BLOCK COmmon_bloclC_name HAS 2 DIFFERENT LENGTHS, SECOND FOUND IN MODULE 
module_name 

Severity: Error. 
Description: Self-explanatory. 



o 

o 
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20219 ERROR ENCOUNTERED IN SYMBOL TABLE IN MODULE moduie_rtame 

Severity: Error. 

Description: Self-explanatory, recompile module. 

20220 ERROR ENCOUNTERED IN LINE TABLE IN MODULE module_name 

Severity : Error . 

Description: Self-explanatory, recompile module. 

20301 NUMBER OF INPUT FILES DOES NOT EQUAL NUMBER OF OUTPUT FILES 

Severity: Error. 
Description: Self-explanatory. 

20302 MISSING IDENTIFICATION RECORD ON FILE file_name 

Severity: Error. 
Description: Self-explanatory. 

20302 FOUND A TEXT RECORD THAT IS NOT SUPPORTED FOR MC68000 ON FILE file_name 

Severity: Error. 
Description: Self-explanatory. 



o 

o 
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OBJECT TEXT FORMATS FOR THE MC68000 B 

ABSOLUTE LINKER 

This appendix contains the CYBIL type and constant declarations that define 
the format for files of object modules that are input to the MC68000 Absolute 
Linker. These formats are consistent with object files created by the CDCNET 
CYBIL compiler and the MC68000 Cross-Assembler. 

{ Date request return value. } 

TYPE 

ost$date = record 

CASE date_format: ost$date_formats OF 
=osc$month_date= 

month: ost$month_date, { month DD, YYYY } 
=osc$mdy_date= 

mdy: ost$mdy_date , { MM/DD/YY } 
=osc$iso_date= 

iso: ost$iso_date, { YYYY-MM-DD } 
=osc$ordinal_date= 

ordinal: ost$ordinal_date , { YYYYDDD } 
CAS END, 
recend, 

ost$date_formats = (osc$default_date, osc$month_date , osc$mdy_date, 
osc$iso_date, osc$ordinal_date) , 

ost$month_date = string (18), 
ost$mdy_date = string (8), 
ost$iso_date = string (10), 
ost$ordinal_date = string ( 7 ) ; 

{ Time request return value. } 

TYPE 

ost$time = record 

CASE time_format: ost$time_formats OF 
=osc$ampm_time= 

ampm: ost$ampm_time, { HH:MM: AM or PM } 
=osc$hms_time= 

hms: ost$hms_time, { HH:MM:SS } 
=osc$mi 1 1 isecond_time= 

millisecond: ost$millisecond_time, { HH:MM:SS.MMM } 
CASEND, 
recend , 

ost$time_formats = (osc$default_time, osc$ampm_time, osc$hms_time , 
osc$millisecond_time) , 

ost$ampm_time = string (8) , 
ost$hms_time = string (8) , 
ost$millisecond_time = string (12); 



o 

c 
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TYPE 

pmt$program_name = ost$name; 

CONST 

osc$max_name_size = 31, 

osc$null_name = ' ' ; 

TYPE 

ost$name_size = 1 .. osc$max_name_size ; 

TYPE 

ost$name = string (osc$max_name_size) ; 

{ * amdname} 
TYPE 

amt$f ile_name = string ( * ) , 
amt$local_file_name = ost$name; 

{ CYBER 180 PPU characteristic definition. } 

COHST 

llc$max_ppu_number = 20-1, {maximum number of PPUs in a configuration.} 
lle$max_ppu_size = Off f (16); {maximum number of words in a PPU.} 

TYPE 

llt$ppu_address = . . llc$max_ppu_size; 

The general form of an object module is a file of binary records 
with the following topology: 

< object text descriptor # 1 > 

< object text record # 1 > 

< object text descriptor # 2 > 

< object text record # 2 > 

< object text descriptor # n > 
< object text record # n > 

For the sake of simplicity the record descriptor - record pairs / ^ 

will be referred to as records hereafter. ,, J 

For a CPU program, the object text records must be arranged in 
the following order: 

1) . Identification record 

2.) Library, section definition, text, bit string insertion, 

address formulation, external linkage, entry definition, 

relocation, formal parameter specification, actual 

parameter specification and binding template records in 

arbitrary order with the one stipulation that a section 

definition record must precede any other object text 

records that refer to the section. 
3). Transfer symbol record. 






O 
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For a PPU program or overlay, the object text records must be 
arranged in the following order: 

1.) Identification record 
2.) PPU absolute record 



{ Constants that pertain to both the object and load module. } 

CONST 

llc$max_adr_items = 0ffff(16), 
llc$max_ext_items = 0ffff(16), 
llc$max_libraries = 0ffff(16), 
llc$max_rel_i terns = 0ffff(16); 



o 



C 



llc$bit_string_insertion , 
llc$transfer_symbol = 



TYPE 

llt$object_text_descriptor = record 
case kind: llt$object_record_kind of 
= UcSidentification, llc$section_definition, 

llc$entry_def inition , llc$binding_template , 

unused: llt$section_length, {must be zero} 
= llcjlibraries =■ 

number_of _libraries : 1 .. llc$max_libraries, 
= llcltext, llc$replicatlon = 

number_of_bytes: 1 .. llc$max_section_length, 
= llclrelocation = 

number_pf_rel_i terns: 1 .. llc$max_rel_i terns, 
= llc$address_formulation = 

number_of_adr_i terns: 1 .. 1 lc$max_adr_i terns , 
= llc$external_linkage = 

number_of_ext_i terns : 1 .. llc$max_ext_i terns, 
= llc$formal_parameters, llc$actual_parameters , 

llc$cybil_symbol_table_fragment, llc$symbol_table, 
llc$line_table_fragment, llc$symbol_table_fragment = 

sequence_length: llt$section_length, {REP sequence_length OF CELL} 
= llc$ppu_absolute ■ 

number_of _words : llt$ppu_address , 
= llc$allotted_section_definition = 

allotted_section: ost$relative_pointer , { BEL *seq(*) } 
= oct$module_directory, oct$entry_point_directory = 

number_of _directory_entries : integer , 
= llc$68000_absolute = 

number_of_68000_bytes: 1 . . llc$maximum_68000_address, 
= llc$line_table, llc$obsolete_line_table = 

number_of_line_i terns : 1 .. llc$max_line_adr_table_size, 
casend, 
recend ; 



o 
o 



TYPE 

llt$section_ordinal = .. llc$max_section_ordinal, 
llt$section_offset ■ .. llc$max_section_of f set , 
llt$section_length = . . llc$max_section_length, 
llt$section_length_in_bits = .. (llc$max_section_length * 

lle$bits_per_byte) , 
llt$section_address_range = - ( llc$max_section_of f set + 1) . 

llc$max_section_offset; 
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CONST 

llc$max_section_ordinal = 0ffff(16), 
llc$max_section_offset = 7fffffff (16), 
llc$max_section_length = llc$max_section_offset + 1, 
llc$bits_per_byte = 8; 

TYPE 

llt$object_record_kind = (llc$identification, llcllibraries, 
llc$section_def inition, llc$text, llc$replication, 
llclbit_string_insertion, llc$entry_def inition, llc$relocation, 
llc$address_formulation, Hc$external_linkage, llc$formaljparameters, 
Llc$actual_parameters, llc$binding_template, llc$ppu_absolute, 
llc$obsolete_line_table , llc$cybil_symbol_table_f ragment , 
llclallotted_section_def inition, llc$symbol_table , llc$transf er_symbol , 
oct$ library _header, oct$module_directory , oct$entry_point_directory, 
llc$68000_absolute, llc$line_table, llc$line_table_f ragment, 
llc$symbol_table_f ragment) ; 

TYPE 

llt$line_address_table_size = .. llc$max_line_adr_table_size; 

CONST 

llc$max_line_adr_table_size = Offffff (16); 

TYPE 

llt$68000_address = .. llc$maximum_68000_address ; 

CONST 

llc$maximum_68000_address » Offffffff (16); 



{ NOS/180 address constants. } 



CONST 



O 

o 
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{ Ring names. } 



osc$min_ring = 1, { Lowest ring number (most privledged) . } 
osc$max_ring = 15, { Highest ring number (least privledged), 
osc$invalid_ring = 0, 

{ Reserved for Operating System. } 

{ Task Monitor. } 

{ Task services. } 

{ Reserved for system job. } 



} 



osc$os_ring_l = 1, 
osc$tmtr_ring = 2, 
osc$tsrv_ring = 3, 
osc$sj_ring_l = 4 , 
osc$sj_ring_2 = 5, 
osc$sj_ring_3 ■ 6, 

osc$application_ring_l = 7, { Reserved for application subsystems.} 
osc$application_ring_2 ■ 8, 

= 9, 
= 10, 

11, { Standard user task. } 

= 12, { Reserved for user. 



\y 



osc$application_ring_3 
osc$application_ring_4 
osc$user_ring = 
osc$user_ring_l 
osc$user_ring_2 = 13, 
osc$user_ring_3 = 14, 
osc$user_ring_4 = 15; 



.O.S. requests available.} 



{ Reserved for user. ..O.S. requests not available. } 
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{ Virtual address space dimensions. } 

CONST 

osc$maximum_segment = 0fff(16), 
osc$maximunt_offset = 7fffffff (16), 
osc$max_segment_length = osc$maximum_offset + 1; 



{ Global-local key lock definition. } 

TYPE 

ost$key_lock = packed record 

global: boolean, { True if value is global key. } 
local: boolean, { True if value is local key. } 
value: ost$key_lock_value , { Key or lock value. } 

recend , 

ost$key_lock_value =0 .. 3f(16), 



{ CYBER 180 forty eight bit PVA definition. } 

ost$ring = osc$invalid_ring . . osc$max_ring, { Ring number. } 
ost$valid_ring - osc$min_ring .. osc$max_ring , { Valid Ring Number. } 
ost$segment « .. osc$maximum_segment , { Segment number. } 
ost$segment_offset = - osc$maximum_offset .. osc$maxiiraim_offset, 

ost$segment_length = . . osc$max_segment_length, 

ost$relative_pointer = - 7fffffff(16) .. 7fffffff (16), 

ost$pva = packed record 

ring: ost$ring, 

seg: ost$segment, 

offset: ost$segment_offset, 
recend; 



{ Identification record. } 

TYPE 

llt$identification = record 
name: pmt$program_name , 
object_text_version: string (4), 
kind: llt$module_kind, 
time_created: ost$time, 
date_created : ost$date, 
attributes : llt$module_attributes , 
greatest_section_ordinal : llt$section_ordinal , 
generator_id : llt$module_generator , 
generator_name_vers : string (40), 
commentary: string (40) , 
recend ; 

CONST 

llc$object_text_version = ^1.4* ; 
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TYPE 

llt$module_kind » (llc$mi_virtual_state, llc$vector_virtual_state, llc$iou, 
lic$motorola_68000, llc$p_code, llc$motorola_68000_absolute) ; 

TYPE 

llt$module_generator = (llc$algol, llc$apl, llc$basic, llc$cobol, 

llc$assembler, llc$fortran, llc$object_library_generator, llc$pascal, 
llc$cybil, llc$pl_i, llc$unknown_generator, lle$the_c_language, llc$ada, 
llc$real_memory_builder) ; 

TYPE 

llt$module_attributes = set of ( llc$nonbindable , llc$nonexecutable) ; 

{ Library record. } 

TYPE 

llt$libraries = array [ 1 . . * ] of amt$local_f ile_name; 

{ Section definition record. } 

TYPE 

llt$section_definition = record 
kind: llt$section_kind, 

access_attributes : Llt$section_access_attributes , 
section_ordinal: llt$section_ordinal , 
length: llt$section_length, 

allocation_alignment: llt$section_address_range, 
allocation_offset: llt$section_address_range, 
name: pmt$prograin_name, 
recend ; 

TYPE 

llt$section_kind = (llc$code_section, llc£binding_section, 
1 ic$working_storage_section , llc$common_block , 
llc$extensible_working_storage , ilc$extensible_coimion_block , 
llc$lts_reserved) ; 

TYPE 

llt$seetion_access_attributes = set of llt$section_access_at tribute, 

/ > 

llt$section_access_attribute = (llclread, llc$write, llc$execute, v J 

llc$binding) ; "^ 

{ Text record. } 

TYPE 

llt$text = record 

sect ion_ordinal : llt$section_ordinal , 

offset: llt$section_offset, 

byte: array [ 1 . . * ] of . . 255, 
recend; 



^...^* 
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{ Replication record. } 

TYPE 

llt$replication = record 

section_ordinal : llt$section_ordinal , 
offset: llt$section_offset, 
increment: 1 . . llc$max_section_length, 
count: 1 . . llc$max_section_length, 
byte: array [ 1 . . * 1 of . . 255, 
recend ; 



{ Bit insertion record. } 

TYPE 

llt$bit_string_insertion = record 

section_ordinal : llt$section_ordinal , 
offset: llt$section_of f set , 
bit_offset: .. 7, 
bit_length: llt$bit_string_length, 



Ct>it_length: iit*Dit_string_iengtn, 
bit_string: packed array [llt$bit_string_length] of .. 1, 



recend , 

llt$bit_string_length = 1 .. llc*max_bit_string_length; 

CONST 

llc$max_bit_string_length » 63; 



{ Address formulation record. } 

TYPE 

llt$address_formulation = record 

value_section: llt$section_ordinal, 

dest_section: llt$section_ordinal , 

item: array [ 1 .. * ] of llt$address_formulation_itam, 
recend , 

llt$address_formulation_item = record 

kind: llt$internal_address_kind, 

value_offset: llt$section_address_range, { only llc$address can be 
negative . } 

dest_offset: llt$section_offset, 
recend ; 

TYPE 

llt$address_kind = (llcladdress, llc$internal_proc, llc$short_address , 
llc$external_proc, llc$address_addition, llc$address_subtraction) ; 

TYPE 

llt$internal_address_kind = llc$address .. llc$external_proc ; 



O 
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{ External reference record. } 

TYPE II' 

llt$external_linkage = record 
name : pmt$program_name , 
language: llt$module_generator, 
declaration_matching_required : boolean , 

declaration_matching_value: integer, , 

item: array [ 1 . . * ] of llt$external_linkage_item, 
recend , 

llt$external_linkage_item = record 

section_ordinal : llt$section_ordinal , 

offset: llt$section_of f set , 

kind: llt£address_kind, 

of f set_operand : llt$section_address_range , 
recend ; 

{ Entry point definition record. } ^ 

TYPE \...J 

llt$entry_definition = record 

section_ordinal : llt$section_ordinal , 
offset: llt$section_offset, 
attributes : llt$entry_point_attributes , 
name: pmt$program_name , 
language: llt$raodule_generator, 
declaration_matching_required: boolean, 
declarat ion_matching_value : integer , 
recend ; ~. . 

:' ^ 
TYPE A...,- 

llt$entry_point_attributes = set of (llc$retain_entry_point, 
llc$gated_entry_point) ; 

{ Relocation record. } 

TYPE 

llt$relocation = array [ 1 . . * ] of llt$relocation_item, 

llt$relocation_item « record ■,: j 

section_ordinal : llt$section_ordinal, ^—^ 

offset: llt$section_of fset, 

relocating_section : llt$section_ordinal , 

container: llt$relocation_container, 

address: llt$address_type, 
recend ; 

TYPE 

llt$relocation_container = ( llc$two_bytes , llc$three_bytes , llc$four_bytes, 
llc*eight_bytes, llc$180_d_f ield , llc$180_q_field, llc$180_long_d_f ield) ; 

TYPE 

llt$address_type = (llc$byte_positive, llc$two_byte_positive , 

llc$four_byte_positive, llc$eight_byte_positive, llc$byte_signed, 
llc$two_byte_signed, llc$four_byte_signed, llc$eight_byte_signed) ; 



o 
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{ Procedure formal parameter description record. } 

\ 

TYPE 

llt$formal_parameters = record 
procedure_name : pmt$program_name , 
specification: SEQ ( * ), 
recend ; 



{ Procedure call actual parameters record. } 

TYPE 

llt$actual_parameters = record 
callee_name : pmt$program_name , 
language: llt$module_generator, 
line_number_of _call : llt$source_line_number , 
specification: SEQ ( * ), 
recend ; 
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TYPE 

llt$source_line_number = .. 999999; 

{ FORTRAN argument description: used to describe a single actual or } 
{ formal parameter. } 

TYPE 

llt$fortran_argument_desc = record 

argument_type : llt$f ortran_argument_type , 

string_length: llt$fortran_string_length, { only used for type CHAR } 
argument_kind : llt$f ortran_argument_kind , 

array_size: llt$fortran_array_size, { only used for kind ARRAY } 
unknown_argument_ordinal: 1 .. llc$max_fortran_arguments, { only used } 
{ for actual argument kind of UNKNOWN. Points back to formal parameter } 
{ passed on by this call. } 
mode: llt$argument_usage, 
recend ; 

CONST 

llc$max_fortran_arguments = 500; 

TYPE 

llt$fortran_argument_type = (llc$fortran_logical, llc$fortran_integer, 
llc$fortran_real, llcjf ortran_double_real , llc$fortran_complex, 
llc$fortran_char, llc$fortran_boolean, llc$fortran_null_type, 
llc$f ortran_statement_label) ; 

TYPE 

llt$fortran_string_length = record 

attributes : llt$f ortran_string_attributes , 
number_of _characters : llt$fortran_string_size, 
recend ; 

TYPE 

llt|fortran_string_size = .. llc$max_fortran_string_size; 



O 
O 
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TYPE 

llt$fortran_string_attributes = set of llt$fortran_string_attribute, 

llt$fortran_string_attribute = ( llc$f ortran_assumed_len_string , 
llc$f sa_reserved_7 , llc$f sa_reserved_6 , llc$fsa_reserved_5, 
llc$f sa_reserved_4 , llc$fsa_reserved_3, llc$fsa_reserved_2, 
llc$f sa_reserved_l) ; 

» 
CONST 

llc$max_fortran_string_size = 0ffff(16); 

TYPE 

llt$fortran_argument_kind = (llc$fortran_variable, llc$fortran_array, 
llc$f ortran_external , lle$f ortran_array_e lament , 
llc$f ortran_unknown_arg_kind) ; 

TYPE 

llt$fortran_array_size = record 

attributes: llt$f ortran_array_attributes , 

rank: llt$fortran_array_rank, ^ 

number_of _elements : llt$section__length, /'■' : 

recend; "^J 

TYPE 

llt$fortran_array_attributes =set of llt$fortran_array_attribute, 

llt$fortran_array_attribute = (llc$fortran_assumed_len_array, 

llc$f ortran_adaptable_array , llc$f aa_reserved_6 , llc$f aa_reserved_5 , 
llc$f aa_reserved_4 , llc$f aa_reserved_3 , llc$faa_reserved_2, 
llc$f aa_reserved_l) ; 

TYPE ( 

llt$fortran_array_rank = . . llc$max_f ortran_array_rank; V V 

CONST 

lle$max_fortran_array_rank ■ 7; 

TYPE 

llt$argument_usage ■ (llc$argument_written, llc$argument_not_written) ; 

{ Binding template record } f 

\^ 

TYPE 

llt$binding_template = record 
binding_offset: llt$section_of f set , 
case kind: llt$binding_template_kind of 
« llc$current_module = 

section_ordinal : llt$section_ordinal , 
offset: llt$section_address_range, 
interna l_addres s : llt$internal_address_kind, 
« llc$external_reference = 
name : pmt$program_name , 
address: llt$address_kind, 
casend, 
recend; 
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TYPE 

llt$binding_template_kind » (llc$current_module, llc$external_ref erence) ; 

{ Symbol table record } 

TYPE 

llt$symbol_table = record 

language: llt$module_generator , 
text: SEQ ( * ), 
recend ; 



{ Debug table record used for emitting line tables and symbol tables } 

{ in fragments rather than all together. Not used by II compilers and } 

{ simply passed over by any object text processors operating on NOS/VE. } 

{ Intended for use by compilers producing this loader text on machines } 

{ other than 180. For example CYBIL C/M. } 

TYPE 

llt$debug_table_fragment = record 
offset: llt$section_offset, 
text: SEQ ( * ), 
recend; 



{ Transfer record. } 

TYPE 

llt$transfer_symbol - record 

name : pmt$program_name , 
recend ; 



{ PPU absolute record. } 

TYPE 

llt$ppu_absolute = record 

executes_on_any_ppu: boolean, 
ppu_number: . . llc$max_ppu_number, 
load_address : llt$ppu_address, 
entry_address: llt$ppu_address, 
text: array [ . . * ] of . . 0ffff(16), 

recend ; 

TYPE 

llt$68000_absolute « record 

load_address : llt$68000_address , 
transf er_address : llt$68000_address , 
text: SEQ ( * ), { REP n OF byte } 

recend; 
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